using JGSY.CMS.LowCode.Platform.Application.DTOs;
using System.Collections.Generic;
using System.Threading.Tasks;

namespace JGSY.CMS.LowCode.Platform.Application.Interfaces
{
    /// <summary>
    /// 安全事件服务接口。
    /// 提供安全事件的底层数据操作、事件记录等安全事件处理相关底层服务功能接口定义。
    /// </summary>
    public interface ISecurityEventService
    {
        /// <summary>
        /// 获取所有安全事件
        /// </summary>
        /// <returns>安全事件列表</returns>
        Task<IEnumerable<SecurityEventDto>> GetAllAsync();
        
        /// <summary>
        /// 根据ID获取安全事件
        /// </summary>
        /// <param name="id">安全事件标识符</param>
        /// <returns>安全事件信息</returns>
        Task<SecurityEventDto?> GetByIdAsync(long id);
        
        /// <summary>
        /// 添加新的安全事件
        /// </summary>
        /// <param name="entity">安全事件数据传输对象</param>
        /// <returns>添加任务</returns>
        Task AddAsync(SecurityEventDto entity);
        
        /// <summary>
        /// 更新安全事件信息
        /// </summary>
        /// <param name="id">安全事件标识符</param>
        /// <param name="entity">安全事件数据传输对象</param>
        /// <returns>更新任务</returns>
        Task UpdateAsync(long id, SecurityEventDto entity);
        
        /// <summary>
        /// 删除安全事件
        /// </summary>
        /// <param name="id">安全事件标识符</param>
        /// <returns>删除任务</returns>
        Task DeleteAsync(long id);
    }
}
